oooonnnneeeemmmmaaaapppp organizes the color map of the currently active framebuffer as a
single map. Because single map mode is the default value for all GL
framebuffers, it can be called in any of the framebuffer drawmodes
(NNNNOOOORRRRMMMMAAAALLLL,,,, PPPPUUUUPPPPDDDDRRRRAAAA,,,, OOOOVVVVEEEERRRRDDDDRRRR,,,, and UUUUNNNNDDDDEEEERRRRDDDD). To return the normal framebuffer
to single map mode, however, you must call oooonnnneeeemmmmaaaapppp while in drawmode
NNNNOOOORRRRMMMMAAAALLLL.
The single color map allocated to a framebuffer in oooonnnneeeemmmmaaaapppp mode has as
many entries as are supported by the bitplanes in that framebuffer. The
normal framebuffer has up to 12 bitplanes, and therefore up to 4096 color
map entries. Call ggggeeeettttppppllllaaaa after setting draw mode to the desired
framebuffer to determine the color map size. ggggeeeettttggggddddeeee can also be called
at any time to determine the size of the color map of any framebuffer.
oooonnnneeeemmmmaaaapppp does not take effect until ggggccccoooonnnnffffiiii is called. When called, ggggccccoooonnnnffffiiii
executes oooonnnneeeemmmmaaaapppp requests pending for all draw modes, regardless of the
current draw mode.
A framebuffer's color map is used to display pixels only if the
framebuffer is in color map mode (see ccccmmmmooooddddeeee).